home *** CD-ROM | disk | FTP | other *** search
/ Massive MOD Collection / Massive MOD Collection.iso / player_4 / dpp.doc < prev    next >
Text File  |  1993-11-22  |  11KB  |  273 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 DPP.DOC
  6.  
  7.                Documentation for the Digital Player Pro
  8.  
  9.                    Copyright (C) 1993 Riku Aakkula
  10.  
  11.  
  12.  Digital Player Pro is cardware so you can freely distribute
  13.  it and I hope you do, as long as you include this help file
  14.  with the executable. If you like the product, please send me
  15.  a postcard to the address shown on the endscreen of DPP !
  16.  
  17.  This player uses DSMI playing routines to play music.
  18.  FFT-unit was made by my friend Esa Hyytiä.
  19.  
  20.            Here is the command line syntax:
  21.  
  22.            DPP [options] [modulename] [@modlist] [options]
  23.  
  24.        Where:
  25.        ------
  26.        modulename : name of a module (wildcards *,? allowed)
  27.            modlist    : name of a file containing list of module names
  28.  
  29.        options  : -Sxxxx          set sampling rate 4000-44100
  30.                       alternatively 4-44
  31.               -H or -?          show help screen
  32.                       -Ix             IRQ number
  33.                       -Pxxx           port address
  34.               -Dx          DMA channel
  35.               -O          Scramble module order
  36.               -L          Inhibit looping
  37.               -M          Mono mode (SB16 & PAS)
  38.               -Cx             Desired card where x is:
  39.                     1 for Sound Blaster
  40.                     2 for Sound Blaster Pro
  41.                     3 for PAS+
  42.                     4 for PAS16
  43.                     5 for SB16
  44.                     7 for Aria cards
  45.  
  46.  If you use some options all the time, you can put them into an
  47.  environment variable dpp:
  48.  
  49.     Example:
  50.  
  51.  You always want to use sampling rate of 22kHz and
  52.  mono mode, put following line into your AUTOEXEC.BAT
  53.  
  54.         SET dpp=-s22 -m
  55.  
  56.  NOTE!  You cannot override single letter options (-l,-o,-m,) with
  57.  command line parameters. All other options can be overridden.
  58.  
  59.  You may have to  give your soundcard's IRQ  number and/or port address
  60.  if dpp fails to find them. If you don't provide both values then dpp
  61.  will assume 220h for port address, and 7 for interrupt number. Giving
  62.  wrong address    will hang  your machine,  but wrong interrupt number
  63.  only stops the playing after a second. The "/C" option is useful if you
  64.  want to use some other card, than the one dpp automatically detects.
  65.  
  66.  You don't  have  to add  any extension  to  the name,  because the
  67.  program will try  extensions AMF, STM, 669, S3M, MOD and  NST if it
  68.  doesn't find the file. Note that you can supply many modulenames and
  69.  list files, up to the internal limit of 1024 modulenames.
  70.  
  71.        Example:
  72.  
  73.            dpp @modlist
  74.  
  75.            modlist is a text file containing following lines:
  76.            harmonic.mod
  77.            cant.s3m
  78.            2unlimit.mod
  79.  
  80.  dpp  will use  the  sampling  rate  of  20KHz  and  play following
  81.  modules: HARMONIC.MOD, CANT.S3M, 2UNLIMIT.MOD.
  82.  
  83.  
  84.                                 How to use dpp
  85.  
  86.  After dpp has  loaded the first  module, it starts  to play it and
  87.  shows some information about it. dpp displays module's  name, its file
  88.  size, the amount of free memory and sampling rate.
  89.  While playing, dpp updates fields showing current
  90.  pattern, row, elapsed time, volume and sampling rate. Under these
  91.  fields are four lines showing the current status of the corresponding
  92.  tracks. Here is an example:
  93.  
  94.  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  95.    Solo_string         ▐▐ F#2  64              ▐▐1.. ■■■■■■■■■■■■■■■■■■■■■
  96.    -----------         ▐▐ D-3  20  ARPEGGIO    ▐▐2.. ■■■■■■■■■■■■■■■
  97.    Greetz_to           ▐▐ E-2  12  PORT.NOTE   ▐▐3.. ■■■■■■
  98.    Matrix_and_Jammer   ▐▐ G-2  57  FINE VOL    ▐▐4.. ■■■■■■■■■■■■■■■■■■
  99.    hello_there         ▐▐ F#2  64              ▐▐5.. ■■■■■■■■■■■■■■■■■■■■■
  100.    by                  ▐▐ D-3  20  VOLUME SLIDE▐▐6.. ■■■■■■■■■■■■
  101.    Nixon /             ▐▐ E-2  12  PORTA TO NOT▐▐7.. ■■■■■■■■■
  102.    Hardware Damage     ▐▐ G-2  57  FINE VOL    ▐▐8.. ■■■
  103.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  104.  
  105.  The first  field shows  the instrument  currently playing  on that
  106.  track. Second is the note value, third its volume and fourth indicates
  107.  what special command is running. The bar simulates a VU  meter on music
  108.  equipment, but you shouldn't take it  as  an exact  representation of
  109.  the music  level, it's there because it looks nice!
  110.  
  111.  Under that comes some info about samples. Sample's name, size and
  112.  sampling rate, with which the sample has been sampled.
  113.  
  114.  There are also two little red bars in borders. They indicate the raster time
  115.  taken from the CPU by the playing routine. The shorter they are the faster
  116.  your computer is !
  117.  
  118.  ---- Spectrum Analyzer ----
  119.  
  120.  A new feature to DPP is now added. The Spectrum Analyzer shows the frequencies
  121.  included in the sound being played. If you have a 386 machine it is wise to
  122.  turn the power meter off while watching the Spetrum Analyzer.
  123.  
  124.  
  125.  10                                                    The higher the pillar is
  126.    ▒                                                   the more sound is being
  127.    ▒ ▒                                                 played in that frequency.
  128.    ▒ ▒                      ▒
  129.    ▒▒▒                      ▒                          At the left are bass-
  130.  05▒▒▒            ▒         ▒▒                         voices. At the right
  131.    ▒▒▒            ▒         ▒▒                         are treble-voices.
  132.    ▒▒▒   ▒        ▒        ▒▒▒                ▒
  133.    ▒▒▒ ▒ ▒        ▒▒       ▒▒▒                ▒
  134.    ▒▒▒ ▒▒▒     ▒  ▒▒       ▒▒▒▒      ▒      ▒ ▒▒   ▒
  135.  00▒▒▒▒▒▒▒▒ ▒  ▒▒ ▒▒▒  ▒ ▒▒▒▒▒▒ ▒ ▒▒ ▒  ▒▒▒▒▒▒▒▒  ▒▒▒
  136.  
  137.  ---- Scope ----
  138.  
  139.  I added the scope to this product because some users wanted it. Everybody knows
  140.  how a scope works and I'm not going to explain it here. To get back to DPP from
  141.  the scope press <space>.
  142.  For 16-bit cards there is now a two-channel scope which means that the scope
  143.  gives the right and the left channel separated.
  144.  
  145.  -----Panning and SURROUND ---------
  146.  
  147.  I added SURROUND and panning to DPP. There is a small problem with panning-
  148.  left. I don't know if it works but I hope You can inform me about any problems.
  149.  
  150.  -----------------------------------
  151.  
  152.  Pressing 'H' brings up a quick-help showing command line options and the keys
  153.  used to control the program.
  154.  
  155.            Keys :
  156.           ────────
  157.  
  158.        P        pause module, any key resumes
  159.            1,2,3,...    turn track xx on/off (ascii characters 49-64)
  160.        N        load next module (if you have supplied more than one)
  161.        S        stereo mode on/off (SB Pro), default is on
  162.        left/right    Jump to next/previous pattern
  163.        F1-F10,+,-    set volume
  164.            (,)          Set new speed
  165.            ,,.          Set new tempo
  166.        H        Help screen
  167.            C            Clear information screen
  168.            A            Spectrum Analyzer on / off
  169.            B            Power-meter on / off
  170.            O            Scope on / off
  171.            up/down      Move cursor
  172.            U            SURROUND sound
  173.            M            Panning middle
  174.            L            Panning left
  175.            R            Panning right
  176.            ESC          exit
  177.  
  178.  
  179.  ---------------- ■■■!!!!! A  T  T  E  N  T  I  O  N !!!!!■■■ ----------------
  180.  
  181.  
  182.  This player doesn't support EMS-memory yet, which means that you can't load
  183.  modules over approx. 480kb. (like PANIC.S3M, RHYTHM.MOD...)
  184.  
  185.  
  186.  -----------------------------------------------------------------------------
  187.  
  188.                            ╔══════════════════════╗
  189.                            ║ Contacting the author║
  190.                            ╚══════════════════════╝
  191.  
  192.        ┌─────────────────────────────────────────────────────────────────────┐
  193.        │                                                                     │
  194.        │   By mail:                                                          │
  195.        │   ────────                                                          │
  196.        │                                                                     │
  197.        │            Riku Aakkula                                             │
  198.        │            Katajakuja 4                                             │
  199.        │            SF-35600 Halli                                           │
  200.        │            FINLAND                                                  │
  201.        │                                                                     │
  202.        │                                                                     │
  203.        │   InterNet:                                                         │
  204.        │   ──────────                                                        │
  205.        │            ra@jybox.jyu.fi (fastest method to contact)              │
  206.        │                                                                     │
  207.        └─────────────────────────────────────────────────────────────────────┘
  208.  
  209.  
  210.        Newest version is always available at :
  211.  
  212.        ┌─────────────────────────────────────────────────────────────────────┐
  213.        │                                                                     │
  214.        │ BBS                    Open         Speed   Number                  │
  215.        │ ---                    ----         -----   ------                  │
  216.        │ R.A.LAW                24h          16.8k   +358-37-49007           │
  217.        │ Chaotic Vision         24h          14.4k   +358-42-714528          │
  218.        │                                                                     │
  219.        │ The Maze of Madness    24h          14.4k   +55-61-3613206          │
  220.        │                                                                     │
  221.        └─────────────────────────────────────────────────────────────────────┘
  222.  
  223.  
  224.        See DPP.REV for revision history.
  225.  
  226.  
  227.  
  228.  To SYSOPS :
  229.  
  230.  I am looking for a distribution sites for DPP. If you are interested in
  231.  having to be a dist. site for DPP contact me !
  232.  
  233.  And finally some greetings :
  234.  
  235.  Jussi Moisio (ß), Riku Pulkkinen (ß), Tero Tolonen, Esa Hyytiä,
  236.  Jussi Lahdenniemi, Otto Chrons, Marko Suovula, Pirkka Palosaari, Kari Sorsimo,
  237.  Juha Perälä, Tero Reunanen, Janne Tuominen, Jukka Sjöstedt, Mikko Valle,
  238.  Jarkko Finni, Sebastian Siukonen, Marko Rautala, Juha Jalas, Jeremy Edman (ß)
  239.  and everybody who likes this product !
  240.  
  241.  (ß) after name means that he is a beta-tester !
  242.  
  243.  Special greetings to:
  244.  
  245.  Brad Craig / Advanced Gravis : keep up the good work!
  246.  
  247. --------------------------------------------------------------------------------
  248.  
  249.  
  250.  TO GFX ARTISTS and MUSIC MAKERS :
  251.  
  252.  A new (demo) group has been founded in 5.6.1993. So, we have
  253.  four members and we are looking for some more. If you have superior talents in
  254.  gfx or music contact us !
  255.  
  256.  The address is mentioned above !!!!!
  257.  
  258. --------------------------------------------------------------------------------
  259.  
  260.  
  261. ---------------------------- N  O  T  E  ! ! ! ---------------------------------
  262.  
  263.  Due to some financial problems it hasn't been possible to test this product
  264.  with all the soundcards it is supposed to support. If you encounter some
  265.  hardware related problems (or problems of any kind) please send me a detailed
  266.  description of them. I do NOT take any responsibility of any permanent damage
  267.  possibly caused by this program. Don't worry, I haven't encountered any
  268.  problems that serious so far, but still...
  269.  
  270.  The fastest way to contact me is via Internet !
  271.  
  272. --------------------------------------------------------------------------------
  273.